[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]Gets a collection of management pack objects that are related to the list of identifiers, from any containment relationship. This is further filtered by the management pack class and derived classes, traversal depth, and query options. Namespace: Microsoft.EnterpriseManagement
Assembly: Microsoft.EnterpriseManagement.Core (in microsoft.enterprisemanagement.core.dll)

Usage

Visual Basic
Dim instance As IEntityObjectsManagement
Dim instanceIds As ICollection(Of Guid)
Dim managementPackClass As ManagementPackClass
Dim traversalDepth As TraversalDepth
Dim queryOptions As ObjectQueryOptions
Dim returnValue As Dictionary(Of Guid, IList(Of T))

returnValue = instance.GetRelatedObjects(instanceIds, managementPackClass, traversalDepth, queryOptions)

Syntax

Visual Basic
Function GetRelatedObjects(Of T As EnterpriseManagementObject) ( _
		instanceIds As ICollection(Of Guid), _
		managementPackClass As ManagementPackClass, _
		traversalDepth As TraversalDepth, _
		queryOptions As ObjectQueryOptions _
) As Dictionary(Of Guid, IList(Of T))
C#
Dictionary<Guid,IList<T>> GetRelatedObjects<T> (
		ICollection<Guid> instanceIds,
		ManagementPackClass managementPackClass,
		TraversalDepth traversalDepth,
		ObjectQueryOptions queryOptions
) where T : EnterpriseManagementObject
C++
generic<typename T> where T : EnterpriseManagementObject
Dictionary<Guid, IList<T>^>^ GetRelatedObjects (
		ICollection<Guid>^ instanceIds, 
		ManagementPackClass^ managementPackClass, 
		TraversalDepth traversalDepth, 
		ObjectQueryOptions^ queryOptions
)
J#

JScript

GenericParameters

T

The type to cast the management pack instances as.

Of type EnterpriseManagementObject.

Parameters

instanceIds

Type: System.Collections.Generic.ICollection{System.Guid}

List of unique object identifiers.

managementPackClass

Type: ManagementPackClass

The management pack class to search for, including derived classes.

traversalDepth

Type: TraversalDepth

One of the enumeration values.

queryOptions

Type: ObjectQueryOptions

The query options.

Return Value

Type: Dictionary A dictionary object of discovered objects.

Exceptions

Exception type Condition
ArgumentNullException

The returned instances are null (Nothing in Visual Basic) or the managementPackClass parameter is a null reference.

ArgumentOutOfRangeException

The returned instances are empty.

InvalidOperationException

The returned instances contained duplicates.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP

Target Platforms

Windows Server 2008,Windows Server 2003

See Also